home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 018a / af125.zip / AF.INF < prev    next >
Text File  |  1993-04-03  |  22KB  |  578 lines
  1. ---------------------------------------------------------------------------
  2. Annexe à la documentation de AF.EXE
  3. ---------------------------------------------------------------------------
  4. Ce fichier contient la totalité des informations à ma disposition pour
  5. la création de ce programme. Il pourra vous être utile un jour, peut-être.
  6. ---------------------------------------------------------------------------
  7.  
  8.  
  9.  
  10.  
  11. -----------------------------
  12. ARJ - Extrait de TECHNOTE.DOC
  13. -----------------------------
  14.     ARJ archives contains two types of header blocks:
  15.  
  16.        Archive main header - This is located at the head of the archive
  17.        Local file header   - This is located before each archived file
  18.  
  19.     Structure of archive block (low order byte first):
  20.  
  21.     Bytes Description
  22.     ----- -------------------------------------------------------------------
  23.       2   header id (main and local file) = 0xEA60 or 60000U
  24.       2   basic header size (from 'first_hdr_size' thru 'comment' below)
  25.                 = first_hdr_size + strlen(filename) + 1 + strlen(comment) + 1
  26.                 = 0 if end of archive
  27.  
  28.       1   first_hdr_size (size up to and including 'extra data')
  29.       1   archiver version number
  30.       1   minimum archiver version to extract
  31.       1   host OS   (0 = MSDOS, 1 = PRIMOS, 2 = UNIX, 3 = AMIGA, 4 = MACDOS)
  32.       1   arj flags (0x01 = GARBLED_FLAG) indicates passworded file
  33.                     (0x02 = RESERVED)
  34.                     (0x04 = VOLUME_FLAG)  indicates continued file to next
  35.                                           volume
  36.                     (0x08 = EXTFILE_FLAG) indicates file starting position field
  37.                     (0x10 = PATHSYM_FLAG) indicates path translated
  38.                                           ("\" changed to "/")
  39.       1   method    (0 = stored, 1 = compressed most ... 4 compressed fastest)
  40.       1   file type (0 = binary, 1 = 7-bit text, 2 = comment header)
  41.                     (3 = directory)
  42.       1   reserved
  43.       4   date time modified
  44.       4   compressed size
  45.       4   original size (this will be different for text mode compression)
  46.       4   original file's CRC
  47.       2   filespec position in filename
  48.       2   file access mode
  49.       2   host data (currently not used)
  50.       ?   extra data
  51.           4 bytes for extended file position when used
  52.           (this is present when EXTFILE_FLAG is set)
  53.  
  54.       ?   filename (null-terminated string)
  55.       ?   comment  (null-terminated string)
  56.  
  57.       4   basic header CRC
  58.  
  59.       2   1st extended header size (0 if none)
  60.       ?   1st extended header (not currently used)
  61.       4   1st extended header's CRC
  62.       ...
  63.       ?   compressed file
  64.  
  65.  
  66.     Time stamp format:
  67.  
  68.        31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16
  69.       |<---- year-1980 --->|<- month ->|<--- day ---->|
  70.  
  71.        15 14 13 12 11 10  9  8  7  6  5  4  3  2  1  0
  72.       |<--- hour --->|<---- minute --->|<- second/2 ->|
  73.  
  74.  
  75. ZIP - Extrait de AppNote.Txt
  76. ----------------------------
  77. General Format of a ZIP file
  78. ----------------------------
  79.  
  80.   Files stored in arbitrary order.  Large zipfiles can span multiple
  81.   diskette media.
  82.  
  83.   Overall zipfile format:
  84.  
  85.     [local file header+file data] . . .
  86.     [central directory] end of central directory record
  87.  
  88.  
  89.   A.  Local file header:
  90.  
  91.     local file header signature   4 bytes  (0x04034b50)
  92.     version needed to extract     2 bytes
  93.     general purpose bit flag      2 bytes
  94.     compression method            2 bytes
  95.     last mod file time            2 bytes
  96.     last mod file date            2 bytes
  97.     crc-32                        4 bytes
  98.     compressed size               4 bytes
  99.     uncompressed size             4 bytes
  100.     filename length               2 bytes
  101.     extra field length            2 bytes
  102.  
  103.     filename (variable size)
  104.     extra field (variable size)
  105.  
  106.  
  107.   B.  Central directory structure:
  108.  
  109.       [file header] . . .  end of central dir record
  110.  
  111.       File header:
  112.  
  113.     central file header signature    4 bytes  (0x02014b50)
  114.     version made by            2 bytes
  115.     version needed to extract    2 bytes
  116.     general purpose bit flag    2 bytes
  117.     compression method        2 bytes
  118.     last mod file time         2 bytes
  119.     last mod file date        2 bytes
  120.     crc-32               4 bytes
  121.     compressed size            4 bytes
  122.     uncompressed size        4 bytes
  123.     filename length            2 bytes
  124.     extra field length        2 bytes
  125.     file comment length        2 bytes
  126.      disk number start        2 bytes
  127.     internal file attributes    2 bytes
  128.     external file attributes    4 bytes
  129.     relative offset of local header    4 bytes
  130.  
  131.     filename (variable size)
  132.     extra field (variable size)
  133.     file comment (variable size)
  134.  
  135.       End of central dir record:
  136.  
  137.     end of central dir signature    4 bytes  (0x06054b50)
  138.     number of this disk        2 bytes
  139.     number of the disk with the
  140.     start of the central directory    2 bytes
  141.     total number of entries in
  142.     the central dir on this disk    2 bytes
  143.     total number of entries in
  144.     the central dir            2 bytes
  145.     size of the central directory   4 bytes
  146.     offset of start of central
  147.     directory with respect to
  148.     the starting disk number    4 bytes
  149.     zipfile comment length        2 bytes
  150.     zipfile comment (variable size)
  151.  
  152.  
  153.  
  154.  
  155.   C.  Explanation of fields:
  156.  
  157.       version made by
  158.  
  159.       The upper byte indicates the host system (OS) for the
  160.       file.  Software can use this information to determine
  161.       the line record format for text files etc.  The current
  162.       mappings are:
  163.  
  164.       0 - MS-DOS and OS/2 (F.A.T. file systems)
  165.       1 - Amiga    2 - VMS        3 - *nix    4 - VM/CMS
  166.       5 - Atari ST                  6 - OS/2 1.2 extended file systems
  167.       7 - Macintosh            8 thru 255 - unused
  168.  
  169.       The lower byte indicates the version number of the
  170.       software used to encode the file.  The value/10
  171.       indicates the major version number, and the value
  172.       mod 10 is the minor version number.
  173.  
  174.       version needed to extract
  175.  
  176.       The minimum software version needed to extract the
  177.       file, mapped as above.
  178.  
  179.       general purpose bit flag:
  180.  
  181.           bit 0: If set, indicates that the file is encrypted.
  182.           bit 1: If the compression method used was type 6,
  183.          Imploding, then this bit, if set, indicates
  184.          an 8K sliding dictionary was used.  If clear,
  185.          then a 4K sliding dictionary was used.
  186.           bit 2: If the compression method used was type 6,
  187.          Imploding, then this bit, if set, indicates
  188.          an 3 Shannon-Fano trees were used to encode the
  189.          sliding dictionary output.  If clear, then 2
  190.          Shannon-Fano trees were used.
  191.       Note:  Bits 1 and 2 are undefined if the compression
  192.          method is other than type 6 (Imploding).
  193.  
  194.           The upper three bits are reserved and used internally
  195.       by the software when processing the zipfile.  The
  196.       remaining bits are unused in version 1.0.
  197.  
  198.       compression method:
  199.  
  200.       (see accompanying documentation for algorithm
  201.       descriptions)
  202.  
  203.       0 - The file is stored (no compression)
  204.       1 - The file is Shrunk
  205.       2 - The file is Reduced with compression factor 1
  206.       3 - The file is Reduced with compression factor 2
  207.       4 - The file is Reduced with compression factor 3
  208.       5 - The file is Reduced with compression factor 4
  209.           6 - The file is Imploded
  210.  
  211.       date and time fields:
  212.  
  213.       The date and time are encoded in standard MS-DOS
  214.       format.
  215.  
  216.       CRC-32:
  217.  
  218.       The CRC-32 algorithm was generously contributed by
  219.       David Schwaderer and can be found in his excellent
  220.       book "C Programmers Guide to NetBIOS" published by
  221.       Howard W. Sams & Co. Inc.  The 'magic number' for
  222.       the CRC is 0xdebb20e3.  The proper CRC pre and post
  223.       conditioning is used, meaning that the CRC register
  224.       is pre-conditioned with all ones (a starting value
  225.       of 0xffffffff) and the value is post-conditioned by
  226.       taking the one's complement of the CRC residual.
  227.  
  228.       compressed size:
  229.       uncompressed size:
  230.  
  231.       The size of the file compressed and uncompressed,
  232.       respectively.
  233.  
  234.       filename length:
  235.       extra field length:
  236.       file comment length:
  237.  
  238.       The length of the filename, extra field, and comment
  239.       fields respectively.  The combined length of any
  240.       directory record and these three fields should not
  241.       generally exceed 65,535 bytes.
  242.  
  243.       disk number start:
  244.  
  245.       The number of the disk on which this file begins.
  246.  
  247.       internal file attributes:
  248.  
  249.       The lowest bit of this field indicates, if set, that
  250.       the file is apparently an ASCII or text file.  If not
  251.       set, that the file apparently contains binary data.
  252.       The remaining bits are unused in version 1.0.
  253.  
  254.       external file attributes:
  255.  
  256.       The mapping of the external attributes is
  257.       host-system dependent (see 'version made by').  For
  258.       MS-DOS, the low order byte is the MS-DOS directory
  259.       attribute byte.
  260.  
  261.       relative offset of local header:
  262.  
  263.       This is the offset from the start of the first disk on
  264.       which this file appears, to where the local header should
  265.       be found.
  266.  
  267.       filename:
  268.  
  269.       The name of the file, with optional relative path.
  270.       The path stored should not contain a drive or
  271.       device letter, or a leading slash.  All slashes
  272.       should be forward slashes '/' as opposed to
  273.       backwards slashes '\' for compatibility with Amiga
  274.       and Unix file systems etc.
  275.  
  276.       extra field:
  277.  
  278.       This is for future expansion.  If additional information
  279.       needs to be stored in the future, it should be stored
  280.       here.  Earlier versions of the software can then safely
  281.       skip this file, and find the next file or header.  This
  282.       field will be 0 length in version 1.0.
  283.  
  284.       In order to allow different programs and different types
  285.       of information to be stored in the 'extra' field in .ZIP
  286.       files, the following structure should be used for all
  287.       programs storing data in this field:
  288.  
  289.       header1+data1 + header2+data2 . . .
  290.  
  291.       Each header should consist of:
  292.  
  293.         Header ID - 2 bytes
  294.         Data Size - 2 bytes
  295.  
  296.       Note: all fields stored in Intel low-byte/high-byte order.
  297.  
  298.       The Header ID field indicates the type of data that is in
  299.       the following data block.
  300.  
  301.       Header ID's of 0 thru 31 are reserved for use by PKWARE.
  302.       The remaining ID's can be used by third party vendors for
  303.       proprietary usage.
  304.  
  305.  
  306.       The Data Size field indicates the size of the following
  307.       data block. Programs can use this value to skip to the
  308.       next header block, passing over any data blocks that are
  309.       not of interest.
  310.  
  311.       Note: As stated in the standard PKZIP application notes,
  312.         the size of the entire .ZIP file header, including the
  313.         filename, comment, and extra field should not exceed 64K
  314.         in size.
  315.  
  316.  
  317.       In case two different programs should appropriate the same
  318.       Header ID value, it is strongly recommended that each
  319.       program place a unique signature of at least two bytes in
  320.       size (and preferably 4 bytes or bigger) at the start of
  321.       each data area.  Every program should verify that it's
  322.       unique signature is present, in addition to the Header ID
  323.       value being correct, before assuming that it is a block of
  324.       known type.
  325.  
  326.  
  327.       file comment:
  328.  
  329.       The comment for this file.
  330.  
  331.  
  332.       number of this disk:
  333.  
  334.       The number of this disk, which contains central
  335.       directory end record.
  336.  
  337.       number of the disk with the start of the central directory:
  338.  
  339.       The number of the disk on which the central
  340.       directory starts.
  341.  
  342.       total number of entries in the central dir on this disk:
  343.  
  344.       The number of central directory entries on this disk.
  345.  
  346.       total number of entries in the central dir:
  347.  
  348.       The total number of files in the zipfile.
  349.  
  350.  
  351.       size of the central directory:
  352.  
  353.       The size (in bytes) of the entire central directory.
  354.  
  355.       offset of start of central directory with respect to
  356.       the starting disk number:
  357.  
  358.       Offset of the start of the central direcory on the
  359.       disk on which the central directory starts.
  360.  
  361.       zipfile comment length:
  362.  
  363.       The length of the comment for this zipfile.
  364.  
  365.       zipfile comment:
  366.  
  367.       The comment for this zipfile.
  368.  
  369.  
  370.   D.  General notes:
  371.  
  372.       1)  All fields unless otherwise noted are unsigned and stored
  373.       in Intel low-byte:high-byte, low-word:high-word order.
  374.  
  375.       2)  String fields are not null terminated, since the
  376.       length is given explicitly.
  377.  
  378.       3)  Local headers should not span disk boundries.  Also, even
  379.       though the central directory can span disk boundries, no
  380.       single record in the central directory should be split
  381.       across disks.
  382.  
  383.       4)  The entries in the central directory may not necessarily
  384.       be in the same order that files appear in the zipfile.
  385.  
  386.  
  387. --------------------------
  388. ARC - Extrait de PkPak.Doc
  389. --------------------------
  390.  
  391. The general format for an archive file is:
  392.  
  393. [[archive-mark + header_version + file header + file data]...] +
  394. archive-mark + end-of-arc-mark
  395.  
  396. The archive-mark is 1 byte and is the value 1A hex.  The file header
  397. can be defined by the following 'C' structure, and is 27 bytes in size.
  398. Note that this is a "packed" structure with fields aligned on odd-address
  399. boundries.
  400.  
  401. typedef struct archive_file_header
  402.   { char name[13];        /* file name */
  403.     unsigned long size;        /* size of compressed file */
  404.     unsigned short date;    /* file date */
  405.     unsigned short time;    /* file time */
  406.     unsigned short crc;        /* cyclic redundancy check */
  407.     unsigned long length;    /* size of uncompressed file */
  408.   };
  409.  
  410. The name field is the null terminated file name.
  411.  
  412. The size is the number of bytes in the file data area following the
  413. header.
  414.  
  415. The date and time are stored in the same packed format as a DOS
  416. directory entry.
  417.  
  418. The CRC is a 16-bit CRC on the file data area based on a CRC polynomial
  419. from the article by David Schwaderer in the April 1985 issue of PC
  420. Technical Journal.
  421.  
  422. The length is the actual uncompressed size of the file.
  423.  
  424. The header versions are defined as follows:
  425.  
  426. Value    Method        Notes
  427. -----    --------    -----------------------------------------------------
  428.   0      -        This is used to indicate the end of the archive.
  429.   1    Stored        (obsolete) (note 1)
  430.   2    Stored        The file is stored (no compression)
  431.   3    Packed        The file is packed with non-repeat packing.
  432.   4    Squeezed    The file is squeezed with standard Huffman squeezing.
  433.   5    crunched    The file was compressed with 12-bit static Ziv-Lempel-
  434.             Welch compression without non-repeat packing.
  435.   6    crunched    The file was compressed with 12-bit static Ziv-Lempel-
  436.             Welch compression with non-repeat packing.
  437.   7    crunched    (internal to SEA) same as above but with different
  438.             hashing formula.
  439.   8    Crunched    The file was compressed with Dynamic Ziv-Lempel-Welch
  440.             compression with non-repeat packing.  The initial
  441.             ZLW code size is 9-bits with a maximum code size
  442.             of 12-bits (note 2).  An adaptive reset is used
  443.             on the ZLW table when it becomes full.
  444.   9    Squashed    The file was compressed with Dynamic Ziv-Lempel-Welch
  445.             compression without non-repeat packing.  The initial
  446.             ZLW code size is 9-bits with a maximum code size
  447.             of 13-bits (note 3).  An adaptive reset is used
  448.             on the ZLW table when it becomes full.
  449.  
  450. Note 1:
  451.   For type 1 stored files, the file header is only 23 bytes in size,
  452.   with the length field not present.  In this case, the file length
  453.   is the same as the size field since the file is stored without
  454.   compression.
  455.  
  456. Note 2:
  457.   The first byte of the data area following the header is used to
  458.   indicate the maximum code size, however only a value of 12 (decimal)
  459.   is currently used or accepted by existing archive programs.
  460.  
  461. Note 3:
  462.   The algorithm used is identical to type 8 crunched files with the
  463.   exception that the maximum code size is 13 bits - i.e. an 8K entry
  464.   ZLW table.  However, unlike type 8 files, the first byte following
  465.   the file header is actual data, no maximum code size is stored.
  466.  
  467.  
  468.  
  469. ZOO - Extrait de PIBCATZ.PAS
  470. ----------------------------
  471.  
  472. (*----------------------------------------------------------------------*)
  473. (*                  Maps of ZOO file headers and entries                *)
  474. (*----------------------------------------------------------------------*)
  475.  
  476. CONST
  477.    PATHSIZE   = 256                  (* Max length of pathname *);
  478.    FNAMESIZE  = 13                   (* Size of DOS filename   *);
  479.    LFNAMESIZE = 256                  (* Size of long filename  *);
  480.    SIZ_TEXT   = 20                   (* Length of header text  *);
  481.    Valid_ZOO  = $FDC4A7DC            (* Valid ZOO tag          *);
  482.  
  483. TYPE
  484.    Header_Text_Type = ARRAY[ 1 .. SIZ_TEXT   ] OF CHAR;
  485.    FName_Type       = ARRAY[ 1 .. FNAMESIZE  ] OF CHAR;
  486.    LFname_Type      = ARRAY[ 1 .. LFNAMESIZE ] OF CHAR;
  487.    Path_Type        = ARRAY[ 1 .. PATHSIZE   ] OF CHAR;
  488.  
  489.                                    (* ZOO file header *)
  490.    ZOO_Header_Type =  RECORD
  491.                          Header_Text : Header_Text_Type     (* Character text      *);
  492.                          ZOO_Tag     : LONGINT              (* Identifies archives *);
  493.                          ZOO_Start   : LONGINT              (* Where data starts   *);
  494.                          ZOO_Minus   : LONGINT              (* Consistency check   *);
  495.                          ZOO_Major   : CHAR                 (* Major version #     *);
  496.                          ZOO_Minor   : CHAR                 (* Minor version #     *);
  497.                       END;
  498.                                    (* One entry in ZOO library *)
  499.                                    (* Fixed part of entry      *)
  500.    ZOO_Fixed_Type  =  RECORD
  501.                                    (* Fixed part of entry *)
  502.  
  503.                          ZOO_Tag     : LONGINT              (* Tag -- redundancy check *);
  504.                          ZOO_Type    : BYTE                 (* Type of directory entry *);
  505.                          Pack_Method : BYTE                 (* 0 = no packing, 1 = normal LZW *);
  506.                          Next        : LONGINT              (* Pos'n of next directory entry *);
  507.                          Offset      : LONGINT              (* Position of this file *);
  508.                          Date        : WORD                 (* DOS format date *);
  509.                          Time        : WORD                 (* DOS format time *);
  510.                          File_CRC    : WORD                 (* CRC of this file *);
  511.                          Org_Size    : LONGINT              (* Original file size *);
  512.                          Size_Now    : LONGINT              (* Compressed file size *);
  513.                          Major_Ver   : BYTE                 (* Version required to extract ... *);
  514.                          Minor_Ver   : BYTE                 (* this file (minimum)             *);
  515.                          Deleted     : BYTE                 (* Will be 1 if deleted, 0 if not *);
  516.                          Struc       : BYTE                 (* File structure if any *);
  517.                          Comment     : LONGINT              (* Points to comment;  zero if none *);
  518.                          Cmt_Size    : WORD                 (* Length of comment, 0 if none *);
  519.                          FName       : FName_Type           (* Filename *);
  520.  
  521.                          Var_Dir_Len : INTEGER              (* Length of variable part of dir entry *);
  522.                          Time_Zone   : BYTE                 (* Time zone where file was created *);
  523.                          Dir_CRC     : WORD                 (* CRC of directory entry *);
  524.  
  525.                       END;
  526.  
  527.                                    (* Variable part of entry *)
  528.  
  529.    ZOO_Varying_Type = ARRAY[1..4+PATHSIZE+LFNAMESIZE] OF CHAR;
  530.  
  531.                                    (* Varying field definitions follow  *)
  532.                                    (* for descriptive purposes.  Any or *)
  533.                                    (* all of these can be missing,      *)
  534.                                    (* depending upon the setting of     *)
  535.                                    (* Var_Dir_Len above and NamLen and  *)
  536.                                    (* DirLen here.                      *)
  537.  
  538.  
  539. LZH - Recherche personnelle
  540. ---------------------------
  541. Nbr  Oct  Signification
  542. ---  ---  -------------
  543.  1    1   ? Taille du Header - 3
  544.  1    2   ? CheckSum du Header
  545.  5    3   Algorithme utilisé de la forme -lhX- où X est le numéro de l'algo
  546.  4    8   Taille compressée
  547.  4   12   Taille normale
  548.  2   16   Heure
  549.  2   18   Date
  550.  1   20   Attribut du fichier
  551.  1   21   ? Niveau de Header
  552.  1   22   Longueur du nom du fichier
  553.  ?   23   Nom du fichier terminé par $00 (chaîne ASCIIZ)
  554.  
  555. Les significations précédées d'un '?' sont de pures supputations de ma
  556. part et n'engagent que moi, n'ayant qu'un vocabulaire Japonais très limité
  557. et un goût pour le langage C encore plus limité ;-) .
  558.  
  559.  
  560. ---------------------------------------------------------------------
  561.  
  562. Je sais que la documentation des programmes ne doit pas être diffusée
  563. autrement que complète, mais j'espère que les différents auteurs ne
  564. me tiendront pas rigueur de cet écart.
  565.  
  566. I know that the documentations of programs sould not be cut in parts
  567. and distributed this way, but I hope that different authors will let me
  568. do it. Archive Finder is a public domain program and I don't win any
  569. money for writing it. The present file was made for my own use but I
  570. thought these condensed informations might help.
  571. If you are the author of one of the mentionned programs and you do not
  572. want this technical stuff to be present in this file, please let me know
  573. (real and virtual addresses are in file AF.ENG), I'll suppress it in
  574. future releases.
  575. Thank you.
  576.  
  577. ---------------------------------------------------------------------
  578.